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The  RATS  Control  Protocol  (RCP) 


Executive  Summary 

At  the  heart  of  the  DSTO  Theatre  Broadcast  System  (TBS)  information  management 
system  is  an  application  called  RATS  (Real  Time  Scheduler).  RATS  is  responsible  for 
managing  the  flow  of  traffic  broadcast  over  the  TBS.  Its  main  functions  include 
accepting  scheduling  requests  from  users  and  other  system  components  and 
performing  real  time  optimisations  in  order  to  deliver  the  maximum  military  utility  of 
information  broadcast.  This  report  describes  a  protocol  developed  for  communications 
to  and  from  RATS  called  the  RATS  Control  Protocol  (RCP).  RCP  is  used  by  users  to 
submit  scheduling  requests  to  RATS,  by  agents  to  perform  management  functions  on 
RATS,  and  by  RATS  to  deliver  control  information  to  various  entities  within  the  TBS 
server. 
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1.  Introduction 


DSTO,  under  Joint  Project  2008  Phase  3C,  has  developed  a  Theatre  Broadcast  System 
(TBS)  Demonstrator.  It  is  based  on  commercial  hardware  (MPEG  encoders.  Integrated 
Receive  Devices,  Digital  Video  Broadcast  modulators),  military  grade  encrytion 
devices  (KIV-7,  KIV-19)  and  DSTO  developed  software.  One  of  the  key  software 
components  is  RATS  (Real  Time  Scheduler)  which  is  responsible  for  scheduling  all 
information  to  be  passed  over  the  TBS. 

RATS  accepts  requests  from  users  and  other  system  components  and  performs  a  real 
time  optimisation  in  order  to  deliver  the  maximum  military  utility  of  information 
broadcast.  RATS  implements  the  schedule  by  communicating  it  to  the  system 
applications.  All  communications  to  and  from  RATS  are  done  via  a  protocol  called  the 
RATS  Control  Protocol  (RCP).  This  document  describes  this  protocol. 

1.1  Background 

Work  on  RATS  began  in  September  1996  under  Project  Awareness.  It  was  initially 
intended  as  a  tool  to  investigate  QoS  issues  in  heterogenous  networks.  It  quickly 
became  evident  that  RATS  was  ideal  from  controlling  streams  on  broadcast  networks. 
A  UDP  (User  Datagram  Protocol)  based  protocol  was  developed  for  communications 
with  RATS  which  would  evolve  into  RCP.  The  initial  intention  of  the  development  of 
RCP  was  to  provide  a  protocol  to  be  used  solely  for  communications  to  and  from 
RATS.  However  it  is  now  used  for  communication  between  most  entities  within  the 
TBS  demonstrator  system. 

RCP  has  evolved  through  versions  0.0,  0.1, 1.0,  1.1,  and  1.2.  The  version  1.1  was  fixed 
in  October  1998,  and  the  current  version  1.2  was  fixed  in  March  2000. 

1.2  Future  Work 

A  complete  rewrite  of  RCP  is  desirable  at  a  future  date.  This  is  required  because: 

1.  RCP  has  developed  in  a  rather  adhoc  manner  and  as  a  result  a  number  of 
inefficiencies  and  redundancies  exist  in  the  current  version,  and 

2.  A  TCP  based  protocol  has  been  developed  for  communications  between  client 
applications. 

The  new  protocol  would  be  suitable  for  operation  over  TCP  (Transport  Control 
Protocol)  and  UDP.  This  protocol  would  be  used  by  all  entities  within  the  TBS. 
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2.  The  RCP  Protocol 


The  RCP  protocol  (version  1.2)  is  described  in  this  section.  Note  that  all  packet  and 
message  coding  is  according  to  network  byte  order  (MSB  order). 


Packet  Format 

- 2 - 1 - 1 _ 1 _ 2 _ 1  3  1  4  1  5  1  ft  1  7  1 

PASSWORD 

VERSION 

CATEGORY 

MSGl 

MSG  2 

... 

■  ...  MSGN 

CRC 

PASSWORD:  variable 

RCP  password.  Each  RCP  packet  is  encoded  in  one  UDP  packet.  Each  RCP  packet 
commences  with  a  password  to  avoid  conflicting  with  other  packets  that  may  be  on 
the  network.  Currently  the  password  used  is  "smartfish". 

VERSION:  8  bits 

Version  number.  The  version  is  in  the  form  of  "x.y"  where  "x"  is  encoded  in  the 
most  significant  4  bits  (bit  positions  8  -  11  in  the  above  diagram)  and  "y"  is 
encoded  in  the  least  significant  4  bits  (12  -  15).  For  example  "00010010"  would 
represent  RCP  version  1.2. 

CATEGORY:  16  bits 

Device  category.  A  2  octet  bit-field  specifies  the  type  of  device  that  the  RCP  packet 
is  intended  for.  The  codes  are: 


bit  position 

category  code 

Category  description 

15 

rcpCAT_SCHEDULER  =  0 

scheduler 

14 

rcpCAT_PROXY  =  1 

proxy 

14 

rcpCAT_REQUESTOR  =  2 

requestor 

13 

rcpCAT_MANAGER  =  3 

manager 

12 

rcpCAT_FILE_DEVICE  =  4 

file  transfer  device 

11 

rcpCAT_AUDIO_DEVICE  =  5 

audio  device 

10 

rcpCAT_VIDEO_DEVICE=  6 

video  device 

9 

rcpCAT_REPLAY_DEVICE  =  7 

videoclip  replay  device 

8 

rcpCAT_STREAM_DEVICE  =  8 

stream  based  device 

7...0 

reserved 

MSG:  variable 

RCP  messages.  Each  RCP  packet  contains  one  or  more  RCP  variable  length 
messages.  These  follow  the  CATEGORY  field. 


ERROR:  8  bits 

Error  condition.  Encoded  as  an  unsigned  8  bit  integer. 
A  t3^e  1  RESPONSE  message  has  the  following  structure; 


I  o  !  1  I  9  I  ^  I  ii  I  s  I  ^  I  7  I  9  I  9  I  in  I  11  I  n  I  1*^  !  14  I  I 


OPCODE,  HANDLE,  TYPE,  RESPONSE,  ERROR 
As  per  RESPONSE  type  0  message. 

ARC  1;  32  bits 

Unsigned  32  bit  integer. 

A  type  2  RESPONSE  message  has  the  following  structure: 


I  n  I  1  I  0  i  i  4  I  I  A  I  7  I  9  I  9  I  in  I  11  I  12  i  1.3  I  14  I 


OPCODE,  HANDLE,  TYPE,  RESPONSE,  ERROR 
As  per  RESPONSE  type  0  message. 

ARC  1:  variable 
Character  array. 

NULL:  8  bits 

Zero  field  used  to  terminate  ARC  1. 

A  type  3  RESPONSE  message  has  the  following  structure: 


I  n  I  1  I  0  I  3  !  4  I  q  I  A  I  7  I  9  I  9  I  in  I  11  I  12  I  13  I  14  I  I 


OPCODE,  HANDLE,  TYPE,  RESPONSE,  ERROR 
As  per  RESPONSE  type  0  message. 

ARG  1:  32  bits 

Unsigned  32  bit  integer. 

ARG  2: 16  bits 

Unsigned  16  bit  integer. 


A  type  4  RESPONSE  message  has  the  following  structure: 


OPCODE,  HANDLE,  TYPE,  RESPONSE,  ERROR 
As  per  RESPONSE  type  0  message. 


ARG  1:  32  bits 

Unsigned  32  bit  integer. 

ARG  2:  32  bits 
Real.i 

ARG  3:  32  bits 

Unsigned  32  bit  integer. 

ARG  4:  16  bits 

Unsigned  16  bit  integer. 

A  type  5  RESPONSE  message  has  the  following  structure: 


’  To  enable  cross  platform  compatibility  real  numbers  are  encoded  as  signed  32  bit  integers  by 
first  multiplying  by  1000  and  truncating. 


OPCODE,  HANDLE,  TYPE,  RESPONSE,  ERROR 
As  per  RESPONSE  type  0  message. 


LENGTH:  16  bits 


Length  of  ARG  1  field.  Encoded  as  a  16  bit  unsigned  integer. 

ARG  1:  variable 
Character  array. 


ARG  2:  32  bits 

Unsigned  32  bit  integer. 

ARG  3: 16  bits 

Unsigned  16  bit  integer. 

2.1.3  INIT  Message 


The  INIT  message  is  used  by  RATS  to  initialise  a  data  stream  within  an  application,  for 
example  to  request  a  file  transfer  application  to  prepare  to  deliver  a  file. 


n  1  1  1  2  1  3  1  4  1  5  1  fi  1  7 

9  1  9 _ 1 _ U! _ 1 _ U _ 1 _ 12 _ 1 _ 12 _ 1 _ U _ 1 _ 15 _ 

OPCODE 

HANDLE 

TXS 

LOC_NAME 

NULL 

REM_NAME 

NULL 

OPCODE,  HANDLE 

As  per  NULL  message. 

TXS:  8  bits 

The  number  of  transmissions  required.  Encoded  as  an  unsigned  8  bit  integer. 
LOC_NAME:  variable 
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Character  array  specifying  local  name  of  file  to  be  delivered. 
NULL:  8  bits 

Zero  field  used  to  terminate  character  arrays. 

REM_NAME:  variable 

Character  array  specifying  remote  name  of  file  to  be  delivered. 

2.1.4  CLOSE  Message 


The  INIT  message  is  used  by  RATS  to  initialise  a  data  stream  within  an  application,  for 
example  to  request  a  file  transfer  application  to  prepare  to  deliver  a  file. 


- 0 - 1 - 1 - i _ 2 _ 1 _ 3  1  4  1  S  1  f,  i  7 

0  1  <5  1  in  1  n  1  n  1  13  1  14  1  1=; 

OPCODE 

HANDLE 

OPCODE,  HANDLE 

As  per  NULL  message. 

2.1.5  RATE  Message 

The  RATE  message  is  used  by  RATS  to  set  the  data  rate  of  a  data  stream  within  an 


application. 

1 - 0 - 1 - 1 - 1 _ 2 _ 1 _ 3  1  4  1  5  1  6  1  7 

9  1  9  1  10  1  11  1  17  1  1?!  1  14  1  IS  1 

1  OPCODE 

HANDLE 

RATE 

OPCODE,  HANDLE 

As  per  NULL  message. 

RATE:  32  bits 

New  rate  for  data  stream.  Encoded  as  an  unsigned  32  bit  integer. 

2.1.6  FILE_DELIVER  Message 

The  FILE_DELIVER  message  is  used  by  RATS  to  request  the  delivery  of  a  file  by  a  file 
transfer  application.  It  has  not  been  used  in  versions  of  RATS  beyond  2.0. 
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0lll2l.-?l4l5l6l7 

9  1  9  1  10  1  11  t  12  1  1.3  1  14  1  l.l 

OPCODE 

HANDLE 

IP 

PORT 

LOC_NAME 

NULL 

REM_NAME 

NULL 

OPCODE,  HANDLE 

As  per  NULL  message. 

IP:  32  bits 

The  IP  address  of  the  destination  host.  Encoded  as  an  unsigned  32  bit  integer. 
PORT:  16  bits 

The  UDP  port  of  the  destination  host.  Encoded  as  an  unsigned  16  bit  integer. 
LOC_NAME:  variable 

Character  array  specifying  local  name  of  file  to  be  delivered. 

NULL:  8  bits 

Zero  field  used  to  terminate  character  arrays. 

REM_NAME:  variable 

Character  array  specifying  remote  name  of  file  to  be  delivered. 

2.1.7  FRAME_RATE  Message 


The  FRAME_RATE  message  is  used  by  RATS  to  set  the  frame  rate  of  a  video  stream 


0lll2l3l4l5lf.l7 

9  1  9  1  10  1  11  1  12  1  13  1  14  1  15 

OPCODE 

HANDLE 

RATE 

OPCODE,  HANDLE 

As  per  NULL  message. 


RATE:  16  bits 

New  frame  rate  for  video  stream.  Encoded  as  an  unsigned  16  bit  integer. 


2.1.8  ENCODER  Message 

The  ENCODER  message  is  used  by  RATS  to  set  the  coding  scheme  for  a  real-time 
application. 


OPCODE 

- 2 - 1 - 2 - - 1  li  1 _ 1  14  1  15 

HANDLE 

CODE 

OPCODE,  HANDLE 

As  per  NULL  message. 


CODE:  8  bits 

New  coding  scheme.  The  encoder  types  and  their  values  are  as  follows; 


value 

encoder  code 

code  description 

0 

rcpCOD_H261 

h261  video  encoding 

1 

rcpCODJPEG 

JPEG  video  encoding 

2 

rcpCOD_NV 

NV  video  encoding 

3 

rcpCOD_NVDCT 

NVDCT  video  encoding 

4 

rcpCOD_CELLB 

CELLB  video  encoding 

5 

rcpCOD_PCM 

PCM  audio  encoding 

6 

rcpCOD_PCM2 

PCM  audio  encoding  (version  2) 

7 

rcpCOD_PCM4 

PCM  audio  encoding  (version  4) 

8 

rcpCOD_DVI 

DVI  audio  encoding 

9 

rcpCOD_DVI2 

DVI  audio  encoding  (version  2) 

10 

rcpCOD_DVI4 

DVI  audio  encoding  (version  4) 

11 

rcpCOD_GSM 

GSM  audio  encoding 

12 

rcpCOD_LPC4 

LPC  audio  encoding 

2.1.9  QUALITY  Message 

The  QUALITY  message  is  used  by  RATS  to  set  the  quality  of  a  video  stream 


- 2 - 1 - 1 - 1 _ 2 _ 1 _ .314151617 

9  1  9  1  in  1  11  1  12  1  t;  1  14  1  IS 

OPCODE 

HANDLE 

QUAL 

OPCODE,  HANDLE 

As  per  NULL  message. 

QUAL:  16  bits 

New  quality  for  video  stream.  Encoded  as  an  unsigned  16  bit  integer. 
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2.1.10  REQUEST  Message 

The  REQUEST  message  is  used  to  submit  scheduling  requests  to  RATS. 


nil  1  7  1  1  1  4  1  S  1  6  1  7 

9  1  9  1  10  1  11  1  12  1  13  1  14  1  15 

OPCODE 

HANDLE 

USER 

ID  TYPE 

VALUE 

IP 

PORT 

START 

X 

OPCODE,  HANDLE 

As  per  NULL  message. 

USER:  32  bits 

Hashed  user  name  and  password.  The  user  name  and  password  are  appended  and 
then  a  CRC-32  is  calculated.  Encoded  as  an  unsigned  32  bit  integer. 

ID:  4  bits 

Application  identifier. 

TYPE:  4  bits 

Application  type.  This  is  encoded  as  follows: 


Application  type 

Code 

NULL 

0-3 

FILE_DEVICE 

rcpCAT_FILE_DEVICE  =  4 

AUDIO_DEVICE 

rcpCAT_AUDIO_DEVICE  =  5 

VIDEO_DEVICE 

rcpCAT_VIDEO_DEVICE  =  6 

REPLAY_DEVICE 

rcpCAT_REPLAY_DEVICE  =  7 

VALUE:  8  bits 

User  perceived  value  of  request.  Encoded  as  an  unsigned  8  bit  integer. 

IP:  32  bits 

The  IP  address  of  the  requesting  agent.  Encoded  as  an  unsigned  32  bit  integer. 
PORT:  16  bits 

The  UDP  port  of  the  requesting  agent.  Encoded  as  an  unsigned  16  bit  integer. 
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START:  32  bits 

The  requested  start  time.  Encoded  as  a  real. 
X:  variable 

Fields  dependent  on  TYPE. 

For  TYPE  -  FILE_DEVICE,  X  has  the  form: 


— e — 1 _ ] _ 1 _ 2  1  3 

- i - 1 - 5 _ 1 _ 6 _ 1 _ Z _ 

9  1  9  1  10  1  11  1  17  1  1,^  1  14  1 

LOC_NAME 

NULL 

REM_NAME 

NULL 

TML 

PREC 

SIZE 

LOC_NAME:  variable 

Character  array  specifying  local  name  of  file  to  be  delivered. 
NULL:  8  bits 

Zero  field  used  to  terminate  character  arrays. 

REM_NAME:  variable 

Character  array  specifying  remote  name  of  file  to  be  delivered. 
TML:  4  bits 

Timeliness  requirement  of  file  request.  This  is  encoded  as  follows: 


Timeliness 

Code 

NO_SLACK 

0 

SOME_SLACK 

1 

LOTS_OF_SLACK 

2 

PREC:  4  bits 

Precedence  of  file  request.  This  is  encoded  as  follows: 


Precedence 

Code 

ROUTINE 

0 

PRIORITY 

1 

IMMEDIATE 

2 

FLASH 

3 

SIZE:  32  bits 

Size  of  requested  file  in  bytes.  Encoded  as  an  unsigned  32  bit  integer. 
For  TYPE  =  AUDIO_DEVICE  and  TYPE  =  VIDEO_DEVICE,  X  has  the  form: 
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0lll2l3l4l5l6l7l9l9 _ | _ Ifl _ 1 _ U _ 1 _ U _ I _ 12 _ I _ H _ I _ 1^ 

LENGTH 


LENGTH:  32  bits 

Length  is  the  requested  time  for  broadcast  of  the  real-time  stream.  Encoded  as  an 
unsigned  32  bit  integer. 


NAME:  variable 

Character  array  specifying  local  name  of  file  to  be  replayed. 

NULL:  8  bits 

Zero  field  used  to  terminate  character  arrays. 

RATE:  32  bits 

Rate  at  which  requested  file  is  to  be  replayed  at.  Encoded  as  an  unsigned  32  bit 
integer. 


2.1.11  KILL  Message 

The  KILL  message  is  used  to  request  a  task  be  removed  from  the  RATS  schedule. 


n  1  1  1  7  1  3  1  4  1  5  1  6  1  7 

9  1  9  1  10  1  11 _ 1 _ 12 _ 1 _ 12 _ 1 _ li _ 1 _ 15 — 

OPCODE 

HANDLE 

USER 

IP 

PORT 

OPCODE,  HANDLE 

As  per  NULL  message. 

USER:  32  bits 

Hashed  user  name  and  password.  The  user  name  and  password  are  appended  and 
then  a  CRC-32  is  calculated.  Encoded  as  an  unsigned  32  bit  integer. 
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IP:  32  bits 

The  IP  address  of  the  requesting  agent.  Encoded  as  an  unsigned  32  bit  integer. 
PORT:  16  bits 

The  UDP  port  of  the  requesting  agent.  Encoded  as  an  unsigned  16  bit  integer. 
2.1.12  LOGIN  Message 

The  LOGIN  message  is  used  to  remotely  login  to  RATS  to  perform  management 
operations. 


- 2 - 1 - 1 - 1 - 2 _ 1 _ 2 _ 1 _ i _ 1  5  1  h  1  7 

OPCODE 

- 2 - 1 - 2 - 1 - 12 _ 1 _ 11 _ 1 _ 12  1  13  1  14  1  IS 

HANDLE 

USER 

IP 

PORT 

OPCODE,  HANDLE,  USER,  IP,  PORT 

As  per  KILL  message. 

2.1.13  LOGOUT  Message 

The  LOGOUT  message  is  used  to  remotely 

- S - 1 - 1 - 1 - 2 _ 1 _ 2 _ 1 _ i _ 1  5  1  IS  1  7  1 

ogout  of  RATS  after  a  logging  in. 

9  1  9  1  in  1  11  1  17  1  1  14  1  19  1 

OPCODE 

HANDLE  1 

USER 

IP 

PORT 

OPCODE,  HANDLE,  USER,  IP,  PORT 

As  per  KILL  message. 

2.1.14  GET_ACCOUNTS  Message 

The  GET_ACCOUNTS  message  is  used  to  request  RATS  to  send  the  current  user 
accounts  to  the  requesting  agent. 
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nlll2l3l4l5l6l7 

1  9  1  9  1  10  1  n  1  12  1  13 _ 1 _ u _ 1 _ 15 _ 

OPCODE 

HANDLE 

USER 

IP 

PORT 

OPCODE,  HANDLE,  USER,  IP,  PORT 
As  per  KILL  message. 


2.1.15  SET_ACCOUNTS  Message 

The  SET_ACCOUNTS  message  is  used  to  request  RATS  to  update  the  current  user 
accounts. 


n  1  1  1  ?  1  3  1  4  1  5  1  6  1  7 

9  1  9  1  10  1  11  1  12  1  13  1  14  1  15 

OPCODE 

HANDLE 

USER 

IP 

PORT 

LENGTH 

ACCOUNTS 

OPCODE,  HANDLE,  USER,  IP,  PORT 
As  per  KILL  message. 

LENGTH:  16  bits 

Length  of  ACCOUNTS  field.  Encoded  as  a  16  bit  unsigned  integer. 

ACCOUNTS:  variable 

Character  array  with  accounts  information. 

2.1.16  COMPLETE  Message 

The  COMPLETE  message  is  used  to  inform  applications  of  the  completion  of  a  task.  It 
has  been  used  by  MUSTAFA  to  inform  WEB_AGENT  of  the  arrival  of  a  file. 
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— Q — 1 - : - 1 - 2 - 1 - 2 _ \ _ 4  1  5  1  6  1  7 

OPCODE 

HANDLE 

STATUS 

NAME 

NULL 

OPCODE,  HANDLE 

As  per  NULL  message. 

STATUS:  8  bits 

Field  to  specify  the  status  of  the  task  at  completion.  Encoded  as  an  8  bit  unsigned 
integer.  Currently  0  =  unsuccessful  completion,  1  =  successful  completion. 

NAME:  variable 

Character  array  with  task  information  such  as  a  file  name. 

NULL:  8  bits 

Zero  field  used  to  terminate  NAME. 

2.1.17  GET_P ARAMS  Message 


The  GET_P ARAMS  message  is  used  by  RATS  to  request  MUSTAFA  for  its  current 
operational  parameters. 


- 2 - 1 - : - 1 _ 2 _ 1 _ 2 _ 1 _ i _ 1  5  1  6  1  7 

9  1  9  1  in  1  11  1  17  1  IS  1  14  1  19 

OPCODE 

HANDLE 

OPCODE,  HANDLE 

As  per  NULL  message. 

2.1.18  GET_PROG  Message 

The  GET_PROG  message  is  used  by  RATS  to  request  MUSTAFA  for  its  current  file 


status. 

- 2 - 1 - 1 - 1 - 2 _ 1 _ 2 _ 1 _ i _ 1  5  1  6  1  7 

9  1  9  1  in  1  11  1  17  1  IS  1  14  1  19  1 

OPCODE 

HANDLE 

TIME 

- — - - - - - - 
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OPCODE,  HANDLE 

As  per  NULL  message. 

TIME:  64  bits 

Time  to  send  file  progress  express  in  elapsed  seconds  since  00:00  Universal 
Coordinated  Time,  January  1, 1970.  Encoded  as  a  double  precision  real.  Currently 
not  used. 


2.1.19  PARAMS  Message 


The  PARAMS  message  is  used  by  MUSTAFA  to  respond  to  a  GET_PARAMS  request. 


n  1  1  1  ■?  1  1  1  4  1  S  1  6  1  7 

9  1  9  1  10  1  11 _ 1 _ 12 _ 1 _ 12 — 1 — H — i — 12 — 

OPCODE 

HANDLE 

PL 

FO 

DA 

PO 

OPCODE,  HANDLE 

As  per  NULL  message. 

PL:  16  bits 

Payload  length  used  in  MUSTAFA  data  packets.  Encoded  as  a  unsigned  16  bit 
integer. 

FO:  16  bits 

File  information  overhead  in  MUSTAFA  file  information  packets.  Encoded  as  a 
unsigned  16  bit  integer. 

DA:  16  bits 

Data  overhead  in  MUSTAFA  data  packets.  Encoded  as  a  unsigned  16  bit 
integer. 

PO:  16  bits 

Layer  1  &  2  overhead  in  MUSTAFA  packets.  Encoded  as  a  unsigned  16  bit 
integer. 

2.1.20  PROG  Message 

The  PROG  message  is  used  by  MUSTAFA  to  respond  to  a  GET_PROG  request. 


- S - 1 - : - 1 - 2 _ 1 _ 2 _ ^ 1  ■  1  5  1  6  1  7 

9  1  9  1  in  1  11  1  17  1  IS  1  14  1  1"; 

OPCODE 

HANDLE 

NFILES 

_ _ _ 

IDl 

FI 

BYTES  1 

ID  2 

F2 

BYTES  2 

<  »  • 

.  .  . 

IDN 

FN 

BYTES N 

OPCODE,  HANDLE 

As  per  NULL  message. 

NFILES:  16  bits 

The  number  of  files  which  progress  information  is  supplied.  Encoded  as  an 
unsigned  16  bit  integer. 

NFILES;  16  bits 

Payload  length  used  in  MUSTAFA  data  packets.  Encoded  as  an  unsigned  16  bit 
integer. 

ID:  32  bits 

File  identifier.  Encoded  as  an  unsigned  32  bit  integer. 

F:  1  bit 

File  completion  indicator.  If  bit  is  set  then  the  file  has  completed. 

BYTES:  31  bit 

Number  of  bytes  left  to  transmit  for  given  file.  Encoded  as  an  unsigned  31  bit 
integer. 
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2.1.21  TRACE  Message 

The  TRACE  message  is  used  to  set  the  output  trace  level  of  various  TBS  applications 
including  RATS. 


nil  1  7  1  .1  1  4  1  5  1  6  1  7 

9  1  9  1  10  1  11  1  12  1  13  1  14  1  15 

OPCODE 

HANDLE 

TR 

NULL 

OPCODE,  HANDLE 

As  per  NULL  message. 

TR;  variable 

Character  array  with  trace  string. 
NULL:  8  bits 

Zero  field  used  to  terminate  TR. 

2.1.22  STREAM  Message 


The  STREAM  message  is  used  by  RATS  to  establish  a  new  stream  in  a  MUSTAFA 
process. 


nil  I7I3I4I  5I6I7 

1  9  1  9  1  10  1  11  1  12 _ 1 _ 12 _ 1 _ li _ 1 _ 12 — 

OPCODE 

HANDLE 

LOC_PORT 

REM_PORT 

REM_HOST 

OPCODE,  HANDLE 

As  per  NULL  message. 

LOC_PORT:  16  bits 

The  UDP  port  for  the  stream  on  the  local  host.  Encoded  as  an  unsigned  16  bit 
integer. 

REM_PORT:  16  bits 

The  UDP  port  for  the  stream  on  the  destination  host.  Encoded  as  an  unsigned  16 
bit  integer. 

REM_HOST:  32  bits 

The  IP  address  of  the  stream  destination  host.  Encoded  as  an  unsigned  32  bit 
integer. 
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2.1.23  TERMINATE  Message 

The  TERMINATE  message  is  used  to  terminate  a  process. 


OPCODE 

- 2 - 1 - 2 - 1 - iU - L_L1 _ 1-  12  1  13  1  U  I  15 

HANDLE 

OPCODE,  HANDLE 

As  per  NULL  message. 
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